home *** CD-ROM | disk | FTP | other *** search
/ Amiga GIGA Graphic / Amiga GIGA Graphic CDs 1-4 (1994)(Geuther)(Disc 2 of 4)[!].iso / libs / xprjmodem.doc < prev    next >
Text File  |  1994-03-30  |  3KB  |  67 lines
  1.  
  2.            XPR JMODEM File Transfer Protocol, Amiga Version 0.1
  3.           ------------------------------------------------------
  4.  
  5.   Based on original implementation version 1.20 by Richard B. Johnson
  6.   for IBM PC compatibles. Amiga port made by Kenneth Osterberg, released
  7.   into public domain June 10, 1989.
  8.   XPR Amiga Library Version made by Markus Pietz on Okt, 1990.
  9.  
  10.   Diese Files sollten sich im Archiv befinden:
  11.   xprjmodem.library  Die fertige XPRLibrary, compiliert mit AztecC V5.0
  12.   JModem.c           Der C Sourcecode für das Protocol
  13.   docrc.asm          Assembler Sourcecode der für die Checksummen berechnung
  14.                      zuständig ist
  15.   timeout.c          Routine die eine Delay() Funktion bereit stellt.
  16.   libsup.c &         Routinen die beim öffnen und schließen der Library
  17.   mylib.h &          angesprungen werden.
  18.   libstart.asm
  19.   Makefile           Makefile für AztecC V5.0
  20.  
  21.   Kurzanleitung zu JModem:
  22.    Für genaue Informationen über das JModem Protocol siehe die
  23.    Original Anleitung bei der JModem Implemation für PC.
  24.  
  25.   Features:
  26.   o      16-bit CRC für efficiente Fehlerfindung
  27.   o      Eine Limitierte Form von Datencompression.
  28.   o      Schnelle Syncronisation mit der Gegenstelle
  29.   o      Variable Länge der Übertragenden Blöcke von bis zu 8192 Bytes,
  30.          je nach Qualität der Verbindung
  31.   o      Es gibt keine Mindest Größe der übertragenden Blöcke,
  32.          müssen nur 2 Bytes übertragen werden, werden nur 2 übertragen
  33.          ( plus BlockHeader)
  34.  
  35.   Beschränkungen:
  36.   o      Filename, -größe, und änderungs Datum werden nicht übertragen :-(
  37.   o      Das Protocol arbeitet mit Handshaking für jeden Block.
  38.          Das verlangsamt die Übertragung, es muß aber kein Nachteil sein
  39.          weil so schnell auf die Qualität der Übertragungsleitung
  40.          reagiert werden kann.
  41.  
  42.   Datencomprimierung:
  43.    Beim verwendeten Compressionsverfahren ist es nicht sicher das die
  44.    Länge des Blocks wirklich kürzer wird (b.z. bei schon comprimierten
  45.    Files), deshalb werden von Fall zu Fall Comprimierte oder nicht
  46.    Comprimierte Blocks übertragenden.
  47.    Die Compressionsmethode heißt Run-Length-Encoding. Sie wird auch
  48.    bei IFF-Bildern verwendet.
  49.  
  50.   XPR-Implementierung:
  51.    Jedes Programm was mit der XPRZmodem.library functioniert sollte
  52.    auch mit JModem laufen.
  53.  
  54.    Zur Information während der Übertragung werden folgende Daten ausgegeben:
  55.    XPRU_BYTES, XPRU_BLOCKS, XPRU_BLOCKSIZE, XPRU_ERROR, XPRU_MSG, XPRU_FILENAME
  56.    beim Senden zusätzlich: XPRU_FILESIZE
  57.  
  58.    Die Library braucht zum Senden und zum Empfangen einen Filenamen
  59.    weil das Protocol das Mitversenden des Filenamens wie ZModem nicht
  60.    unterstützt.
  61.  
  62.    Folgende Call-Back-Funktionen müssen bereitgestellt werden:
  63.     fopen(),fclose(),fread(),fwrite(),
  64.     sread(),swrite(),sflush(),
  65.     update(),chkabort()
  66.  
  67.